home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr29 / hv104a.zip / HV.DOC < prev    next >
Text File  |  1994-11-08  |  65KB  |  582 lines

  1.                                  HyperView
  2.  
  3.                             USER REFERENCE GUIDE
  4.                                 Version 1.04
  5.  
  6.  
  7.                     Copyright 1994 by Michael H. Shacter
  8.                             10309 Parkwood Drive
  9.                       Kensington, Maryland 20895-4041
  10.  
  11.  
  12. [WHAT IS HYPERVIEW?]
  13.  
  14. HyperView is a file viewer with special capabilities for isolating and extracting information from word processing and text files.  It reads popular word processing formats, as well as ASCII text files.  HyperView is blazingly fast and blissfully easy to use.
  15.  
  16. HyperView lets you focus quickly on pertinent information by automatically tagging lines that match search criteria.  Lines of text may also be tagged and untagged manually.  There is no limit on the number of lines that can be tagged.  Tagged lines may then be viewed in condensed or split screen views.  These powerful features let you easily create a hyperview into your document.
  17.  
  18. There is no learning curve involved in trying the program.  Its power is packaged in a deceptively simple package.  From a user's perspective, it works like any other file viewer.
  19.  
  20.  Note:  An easy way to view this documentation is with HyperView.  From the OS/2 command line, change to the directory containing HV.EXE and HV.DOC.  Then type HV HV.DOC.  Alternatively, open the folder containing HV.EXE and HV.DOC from the drives object on the OS/2 desktop.  Now drag the icon for HV.DOC and drop it on the icon for HV.EXE.
  21.  
  22. To get a quick feel for HyperView's capabilities, try this one paragraph tutorial.  (If you have not already done so, load this file into HyperView.) Press "F" (or "f") to start a search in the forward direction.  In the text box type "example".  Now press Ctrl-Enter (or F9).  Scroll through the text using the Up, Down, Home, End, PgUp and PgDn keys.  Notice that each line containing the search phrase "example" is highlighted.  Press Enter to switch to condensed view.  HyperView will isolate only those lines containing the search phrase.  From condensed view you may (among other things) press (1) Escape to return here (or wherever else you were when you left full screen mode), (2) Enter to jump to the highlighted line, or (3) Ctrl-Enter (or F9) to switch to split screen mode.  You may also search for and tag additional lines, or tag lines manually with the space bar.  Press "C" to untag all lines.
  23.  
  24. You now have a good idea the reverse hypertext capability that distinguishes HyperView.  These are some of HyperView's other features:
  25.  
  26.  ■ Automatically recognizes and reads popular word processing formats, including:  Ami Pro, DeScribe (versions 2 through 5.0), Microsoft Word for Windows (versions 1.x, 2.0, and 6.0) and WordPerfect (versions 5.x and 6.0).
  27.  
  28.  ■ Tag and untag lines of text (a) automatically, from the search dialog, and (b) manually, by pressing the space bar.
  29.  
  30.  ■ View files in full screen, condensed, or split screen views.
  31.  
  32.  ■ Loads files almost instantaneously.
  33.  
  34.  ■ Blazingly fast searches.
  35.  
  36.  ■ Tagged lines may be copied or appended to the OS/2 clipboard or to a file.
  37.  
  38.  ■ All or part of a file may be gathered and copied or appended to the OS/2 clipboard or to a file.
  39.  
  40.  ■ Takes full advantage of the 32-bit OS/2 operating system.
  41.  
  42.  ■ Directory listing to pick file for viewing and to navigate file system.
  43.  
  44.  ■ Adjustable right margin for stripped ASCII and word processing files.
  45.  
  46.  ■ Searches may cross line boundaries when working with word processing and stripped ASCII files.
  47.  
  48.  ■ May be started from the OS/2 DOS command line or a DOS program running in an OS/2 DOS session (VDM).
  49.  
  50.  ■ Supports long file names on HPFS drives.
  51.  
  52.  ■ Case insensitive searches may be performed in any language.
  53.  
  54.  ■ Commands may be invoked without the use of shifted keystrokes.
  55.  
  56.  ■ Perfect for reading files when you must boot off a floppy or when you run OS/2 without Presentation Manager.
  57.  
  58.  Note:  The term "stripped ASCII" is used in this documentation to refer to ASCII files in which a paragraph consists of a single long line.  Stripped ASCII is comparable to the way a word processor treats a paragraph--as one long line with a hard return at the end.  The stripped ASCII format is to be distinguished from text files with a hard return at the end of each line.
  59.  
  60. For your convenience, each of the major headings in this document is enclosed in square brackets ([]).  To create a quick table of contents, (1) press "F" to perform a forward search, (2) type "[" in the text box, (3) set the "Start from:" radio button to "Top of document" by either (a) pressing "Alt-T" or (b) tabbing out of the text box and pressing "T", and (4) press Ctrl-Enter.  (As with so many things, this is much easier to do than to describe.)  By the way, you will note several extraneous lines in condensed view, including two from this paragraph.  Simply move the cursor bar to the offending lines and press the space bar to remove them from condensed view.
  61.  
  62. Because you are probably eager to learn how to use HyperView, I shall have only a few words to say about registration at the beginning of this document.  HyperView is user supported software.  It is not public domain.  In brief, there is a $35 fee to register HyperView.  For business use, each person using HyperView at a site must be registered.  Volume discounts and site licenses are available.  More information concerning registration and licensing may be found toward the end of this document in the section entitled "REGISTRATION".
  63.  
  64.  
  65. [INTRODUCTION]
  66.  
  67. Besides serving as a fast and flexible file viewer, HyperView offers powerful tools for isolating and extracting information from text and word processing files.
  68.  
  69. To appreciate HyperView's power, add the property of the "tagged line" to the features associated with traditional file viewers.  A line may be tagged in one of two ways.  You can have HyperView search through a text file and tag all lines matching your search criteria.  For example, if you took the one-paragraph tutorial, you tagged all lines containing the phrase "example".  Alternatively, a line may be tagged manually by pressing the space bar.  As you read through a document, you may manually tag relevant lines to create a customized outline of pertinent information.
  70.  
  71. From HyperView's full screen view, a tagged line is simply a line with a different color.  The full power of HyperView can be exploited with its condensed and split screen views.  The condensed view is restricted to tagged lines.  In split screen view, tagged lines are displayed in the upper screen.  The lower screen shows in context the line highlighted in the upper screen.
  72.  
  73. Tagged lines are persistent.  This means that a line remains tagged until it is untagged.  For example, you may have instructed HyperView to tag all lines containing the phrase "example".  You may now go back and tag all line lines containing the word "extract".  In condensed view, all lines containing either "example" or "extract" will be displayed.  (This is essentially a boolean OR search, except that (i) you do not need to remember any special syntax, (ii) there is no limitation on the number of searches that can be ORed, and (iii) you can mix case sensitive with case insensitive searches.).
  74.  
  75. In addition, lines that do not easily lend themselves to easy detection by a search may be tagged manually.  Inevitably, the results of any search will be over-inclusive.  Therefore, a line may be untagged by pressing the space bar.  The result is a form of reverse hypertext, allowing you to quickly isolate information from a document.
  76.  
  77. Who might benefit from HyperView's unique capabilities?  Writers, scientists, programmers, lawyers--in fact anyone who works with text.  Here are a few examples.
  78.  
  79. Example 1.  You have a propensity for overusing the adverbs "however" and "therefore".  You know these words appear too frequently in a lengthy letter you are writing.  To decide where additional editing would be most appropriate, you would like to see where each word is used.  Just tell HyperView to search and tag each line containing the word "however".  Then search again for all lines containing "therefore".  Now switch to HyperView's condensed mode to see all lines containing either "however" or "therefore".  Switch to split screen mode to see each line in context.  Please note that you can open a HyperView window to review the letter while it is still active in your word processor.
  80.  
  81. Example 2.  You are reviewing a collection of mail messages.  You search and tag all lines containing the subject heading ("Subj:", "Topic:", etc.).  This gives you a quick list of topics from which you can easily extract messages of interest.
  82.  
  83. Example 3.  You are a scientist specializing in research on sickle cell anemia.  A colleague asks you to review a paper she is writing about genetic disorders.  You do not have to worry that her paper is formatted as a WordPerfect document and you shun DOS based word processors--HyperView reads WordPerfect.  Moreover, you do not need to read the whole paper.  Instead, you use HyperView's search and tag feature to perform three successive searches for (1) "sickle", (2) "hemoglobin", and (3) "HgB".  Press Ctrl-Enter (or F9) to switch to HyperView's split screen view.  In the top screen are all lines containing one of the three words you searched for.  As you move the cursor through the upper screen, the line is shown in context in the lower screen.  Extraneous lines may be untagged by positioning the cursor over the offending line and pressing the space bar.  When you need to read a section more thoroughly, you press Enter to return to the full screen view and jump automatically to the section that interests you.  You use Gather to save one or more sections of text to another file, or List Tags to save all tagged lines to a file.
  84.  
  85.  
  86. [INSTALLATION]
  87.  
  88. There are no special requirements for installing HyperView.  Simply copy HV.EXE, HVAUX.EXE and HV.ICO to a convenient directory.  Please note that all three files *must* be located in the same directory.  You will probably find it most practical to place HyperView in a directory on your path.  If you are upgrading from an earlier version of HyperView, be sure to replace the older copies of both HV.EXE and HVAUX.EXE.
  89.  
  90. You may also wish to create a HyperView object on your desktop.  A HyperView program object may be created using the following method.
  91.  
  92. 1. From the desktop, open the Templates folder.
  93.  
  94. 2. Drag the Program template to the intended destination for the HyperView object--either a folder or your desktop.
  95.  
  96. 3. The Settings notebook will open when you release the mouse button.  Under "Path and file name:", type the full path name of HV.EXE.  Use the "Find..." button, if you do not remember in which directory HV.EXE is located.
  97.  
  98. 4. Enter any optional parameters.  (Optional parameters are described below in the section entitled "Command Line Options".)
  99.  
  100. 5. A "Working directory" is optional.  Specifying a working directory will cause HyperView to display a list of files in the directory when you double-click on the HyperView icon and will not interfere with your ability open files from other directories by dragging them to the HyperView icon.
  101.  
  102. 6. Click on the "General" notebook tab, and type "HyperView" in the "Title" box.
  103.  
  104. 7. Provided that HV.ICO is in the same directory as HV.EXE, OS/2 should select it as the "Current icon".  If not, press "Find..." and enter the full path name for HV.ICO.
  105.  
  106.  
  107. [STARTING HYPERVIEW]
  108.  
  109. The easiest way to start HyperView is from the Workplace Shell.  Drag the icon of a file you wish to view and drop it on the HyperView icon.  Before starting HyperView, you may add any command option to the parameters field of the HyperView object.  (See the section entitled "Command Line Options" below.)
  110.  
  111. You may also start HyperView from any OS/2 command prompt.  The full syntax for starting HyperView is:
  112.  
  113.     HV [options] [filespec]
  114.  
  115. Filespec refers either to (1) a file name, in which case HyperView will load the file at startup, or (2) a path, in which case HyperView will display a directory of files in the designated directory at startup.  The path may be further limited by supplying a file mask.  For example, the path "C:\DeScribe\Data" would result in a directory list of all files (*.*) in the C:\DeScribe\Data directory.  Alternatively, the path "C:\DeScribe\Data\*.doc" would result in a directory list of all files with the .DOC extension (*.doc) in the C:\DeScribe\Data directory.
  116.  
  117. HyperView recognizes HPFS long file names.  There is no need to place quotes around long file names with embedded spaces.  If you do use quotes (through force of habit) place them around the entire file specification--not just the file name.  Please note that only the first twelve characters of the file's name will appear on HyperView's status line.
  118.  
  119. If a filespec is omitted at startup, HyperView will open with a display of the current directory.  If HyperView cannot locate a file specified on the command line, rather than give a "file not found message", it will display a listing of the directory in which the file should be located.
  120.  
  121.  
  122.     [Command Line Options]
  123.  
  124. For your convenience, the following options are available when starting HyperView.  Notice that each option consists of a slash ("/") followed by a letter.  The letter may be upper- or lower-case.  All options must precede the filespec on the command line.
  125.  
  126. /F    Start HyperView in a full screen OS/2 session
  127. /W    Start HyperView in a windowed OS/2 session
  128. /M    Force HyperView to use monochrome
  129. /C    Force HyperView to use color (when it mistakenly
  130.     thinks you have a monochrome monitor)
  131. /A    Use alternative color scheme
  132. /R    Raw (do not convert word processing files)
  133. /B-    Force clipboard feature off
  134. /B+    Force clipboard feature on
  135. /Lnn    Lines of text, where "nn" is a number from between 25 and 60.
  136.  
  137. Use the Program page in the HyperView Settings notebook to type parameters that will affect the way the program starts from the workplace shell.  From the Desktop, click on the HyperView icon with mouse button 2.  Select "Open", then "Settings".  Now, in the parameters field, type in whatever options you wish to have in effect when HyperView starts from the workplace shell.  For example, you might type "/M" to have HyperView start in monochrome.  You do not need to type the "/F" (full screen) or "/W" (window) options in the parameters field.  Instead, click on the "Session" tab of the Settings notebook, then click on "OS/2 window" or "OS/2 full screen".  The "/F" and "/W" options are primarily intended for starting HyperView from the command line or from another program.
  138.  
  139. The "/L" command option is used to set the number of lines of text on screen.  This option takes the form "/Lnn", where nn is a number between 25 and 60.  Thus, to set HyperView to display 30 lines of text, the appropriate option would be "/L30".  When running HyperView in a window, any value in the range is acceptable.  Depending on the display driver, not all values in the range may be permissible in a full screen session.  If an impermissible value is entered, HyperView will try to round up to the next highest acceptable value.  You may wish to experiment with the OS/2 MODE command to determine which values are acceptable for your system.
  140.  
  141. If the "/L" command option is not employed, HyperView will automatically adjust to the number of lines on your display.  The number may be any value from 25 to 60 that is supported by your system.
  142.  
  143. HyperView may also be used with any program that allows the designation of an external file viewer.  The popular FM2 program by Mark Kimes is an example.  To use HyperView as an external file viewer with FM2, select "Config" from the main menu, then "External Program/Path Setup".  Fill in the full path name for HV.EXE in the text entry field for "Viewer", followed by a space and the metastring "%a".  Thus if HV.EXE resides in "C:\UTILITY", you would type "C:\UTILITY\HV.EXE %a".  Note that FM2 will start HyperView in an OS/2 window.  If you prefer to run HyperView in a full screen OS/2 session, use the "/F" option, i.e. "C:\UTILITY\HV.EXE /F %a".  The procedure for using HyperView with other programs should be very similar.  Please note that FM2 uses the metastring "%a" as a shorthand to signify the full path name of the file to be viewed.  Other programs will use different abbreviations.
  144.  
  145.  
  146.     [Starting HyperView From a DOS Session]
  147.  
  148. HyperView may also be started from an OS/2 DOS session (i.e. from a VDM).  The same syntax is used to start HyperView from a VDM as from the OS/2 command line.  When started from a VDM, HyperView will default to OS/2 full screen display mode.  If you prefer to start HyperView in an OS/2 window, add the "/W" option to the command line.
  149.  
  150. If you start HyperView from inside a DOS application, you may notice that the DOS program does not realize HyperView is active.  Usually, when you start one DOS application from within another, the first application remains inaccessible until the second application ends.  In contrast, when you start HyperView from a DOS session, HyperView begins its own OS/2 session.  If you like, use the Window List (Ctrl-Escape) to switch between the DOS program and HyperView.
  151.  
  152.  Note:  Under DOS, drives and directories may be given aliases with the ASSIGN, JOIN, and SUBST commands.  These aliases are not recognized by OS/2.  Therefore, you must give the full path name of the file you wish to view, when the file resides on an aliased drive or directory.
  153.  
  154.  
  155. [USING HYPERVIEW]
  156.  
  157. Although HyperView offers advanced features, it uses a conventional user interface, requiring little, if no, effort to learn.  In deference to those who have difficulty using shifted keystrokes, almost any HyperView command can be accessed with one unshifted keystroke.  Sometimes a shifted keystroke (e.g. Ctrl-Enter) may be suggested as the primary means of effectuating a command because it is the most logical alternative.  In each instance, however, there is an unshifted alternative.  In the case of Ctrl-Enter, the alternative is always F9.  Thus, wherever the program suggests Ctrl-Enter, pressing F9 is always an acceptable alternative.
  158.  
  159. The main HyperView screen consists of a viewing area, a status line, and a scroll bar.  The status line displays the name of the file you are viewing, the number of lines in the file, and the number of the current line.  If the file name consists of more than 12 characters, HyperView will add a diamond character to the end, to signify that only part of the file name is being displayed.
  160.  
  161. HyperView has two types of scroll bar, a conventional one and a virtual one.  Which scroll bar is used depends on the right margin setting and the number of columns in your video mode.  When the right margin is set to a value that is less than the number of columns, HyperView employs a conventional scroll bar consisting of a vertical track and a scroll box indicating the relative position in the file.  When the right margin is greater than or equal to the number of columns, only the block representing the file position is displayed.  The vertical track is omitted because it would obscure a column of text.  Since the most common video mode is 80 columns, this means that for most people when the right margin is 79 or less, there will be a conventional scroll bar.  The scroll box showing the file position contains a down arrow when the cursor bar is at the top of the file and an up arrow at the end of the file.  In virtual mode, the scroll box is transparent--the color changes but the underlying character is visible.  Please note that the scroll bar is only active in full screen view.
  162.  
  163. HyperView displays in one of three views.  In full screen view, all lines of text are displayed.  Tagged lines are differentiated with a distinctive color.  Condensed view is restricted to lines that have been tagged.  In split screen view, tagged lines are displayed in the upper screen.  The lower screen shows in context the line that is highlighted in the upper screen.  The latter two views (condensed and split screen) are only available when one or more lines have been tagged.
  164.  
  165. Lines may be tagged either (1) automatically with the search and tag feature of the Search Dialog, or (2) manually  with the space bar.  Once a line is tagged, it remains tagged until untagged with the Clear Tags command or with the space bar.  Available command options are summarized below.  HyperView letter commands may be either upper- or lower-case.
  166.  
  167. The following commands are available:
  168.  
  169.   Key    Function
  170.  
  171. File Functions
  172.   <N>    New File
  173.   <F5>    Directory (Dialog)
  174.   <\>    Directory (Express)
  175.   <Esc>    Exit (Confirm)
  176.   <Alt-F4>    Exit (Leave screen)
  177.   <Alt-X>    Exit (& CLS)
  178.  
  179. Edit Functions
  180.   <G>*    Gather text to file or clipboard
  181.   <L>    List tagged lines to file or clipboard
  182.   <Space>    Tag/Untag line
  183.   <C>    Clear tagged lines
  184.  
  185. Search Functions:
  186.   <S> ) Search    Search
  187.   <F> )  Dialog    Search Forward
  188.   <B> )    Search Back
  189.   <+>    Repeat Last Search Forward
  190.   <->    Repeat Last Search Back
  191.   <J>    Jump to line number
  192.  
  193. View Functions
  194.   <Enter>    Full Screen
  195.   <Enter>/<F10>    Condensed
  196.   <CtrlEnter>/<F9>    Split Screen
  197.   <R>    Right Margin
  198.   <T>    Tab expansion toggle
  199.  
  200. Cursor Movement
  201.   <Up>    Cursor Up
  202.   <Down>    Cursor Down
  203.   <PgUp>    Screen Up
  204.   <PgDn>    Screen Down
  205.   <Home>**    Top of File
  206.   <End>    End of File
  207.   <Left>    Screen Left 1 column
  208.   <Right>    Screen Right 1 column
  209.   <CtrlLeft>    Screen Left 5 columns
  210.   <CtrlRight>    Screen Right 5 columns
  211.  
  212.  * Gather operations may also be commenced by holding down the shift key in combination with one of the cursor keys (Up, Down, PgUp, PgDn, Home or End).
  213.  
  214. ** When the screen has been scrolled right, the home key first returns the display to the beginning of the line.
  215.  
  216.  
  217. [HYPERVIEW DIALOGS]
  218.  
  219. Where appropriate, HyperView uses dialogs to solicit user input.  Although the dialogs operate in the conventional manner, it may be beneficial to summarize their operation.
  220.  
  221. Dialog Controls
  222.  
  223. HyperView dialogs use four different types of controls:  (1) Text Boxes, (2) Check Boxes, (3) Radio Buttons, and (4) Command Buttons.  These controls are described in detail below.  To move within a dialog box simply press the highlighted letter of the control you want to select (from a Text Box, press Alt + the highlighted letter) or Tab to move forward, Shift-Tab to move in reverse.
  224.  
  225. Text Boxes
  226.  
  227. You type information in a Text Box.  This information might be a search string, the name of a file, or a line number to which you wish to jump.
  228.  
  229. The following rules apply to Text Boxes:
  230.  
  231. (a)  There may be text already in the box, either as a default, or the previous entry at that box.
  232.  
  233. (b)  If you simply start typing, without doing any editing (cursor movement or deleting), then the default text will automatically be deleted.
  234.  
  235. (c)  The following keys are available when editing text:
  236.  
  237.   <Home>            Move cursor to beginning of text
  238.   <End>            Move cursor to end of text
  239.   <Right>            Move cursor right
  240.   <Left>            Move cursor left
  241.   <Ctrl-Left> or <PgUp>    Move cursor word left
  242.   <Ctrl-Right> or <PgDn>    Move cursor word right
  243.   <Del>            Delete character under cursor
  244.   <Backspace>        Delete character to left of cursor
  245.   <Ctrl-Backspace> or <F6>    Delete word
  246.   <Ctrl-End> or <F7>     Delete to end of line
  247.   <Ctrl-Y> or <F8>    Delete all text
  248.   <Insert>        Toggle insert and overstrike
  249.  
  250. Notice that each of the shifted keys (Ctrl-Left, Ctrl-End, etc.) has an unshifted alternative (PgUp, F7, etc.).  When editing a path name, a subdirectory is considered a word.  In other words, when the cursor is positioned on a subdirectory (including the backslash to the right of the subdirectory), the delete word command will excise the subdirectory name from the path.
  251.  
  252. (d) Tab (or Shift-Tab) accepts input, and moves to the next (or previous) field.  Alt + the highlighted letter of a control also accepts text input, then moves directly from a Text Box to the control.  Pressing the key associated with a command button initiates the command button action.
  253.  
  254. Check Boxes
  255.  
  256. Check boxes allow you to turn options on and off.  A "X" indicates an option is on; otherwise, the option is off.  To toggle a check box on and off:  (a) press the highlighted letter of the control you want to select (from the Text Box, press Alt + the highlighted letter), or (b) Tab (or Shift-Tab) to the field, then press the space bar.
  257.  
  258. Radio Buttons
  259.  
  260. Radio buttons are used to select one of two or more mutually exclusive options.  Only one radio button in an option group may be selected at one time.  To select a radio button: (a) press the highlighted letter of the control you want to select (from the Text Box, press Alt + the highlighted letter), or (b) Tab (or Shift-Tab) to the field, then press the up/down keys to select an option in the group.
  261.  
  262. Command Buttons
  263.  
  264. Command buttons are used to initiate an action immediately.  The button describes the action followed by a key name in angled brackets.  For example Search<Enter> or Cancel<Esc>.  This means that you press the Enter key to start a search or the Escape key to cancel a dialog.  You may also Tab or Shift-Tab to a command button and press Enter, but that is less efficient than pressing the key directly.  Command buttons are generally located at the bottom of the dialog box.
  265.  
  266.  
  267. [SEARCHING FOR TEXT]
  268.  
  269. Searches are initiated with the Search Dialog.  Follow-up searches may be performed most conveniently using the "+" and "-" keys.  The gray "+" and "-" keys on the numeric keypad are particularly useful for this purpose.
  270.  
  271.  Note:  It may be helpful to read the section entitled "HyperView Dialogs" together with this section.  To summarize, a dialog consists of some or all of the following parts.  The Text Box is where you enter the text for which you are searching.  For your convenience the Text Box offers an array of keys for editing the text (described in the section entitled "Text Boxes").  The Tab (and Shift-Tab) keys move you forward (or backward) to the next (or previous) control.  Any control may be accessed by pressing the highlighted letter associated with the control.  (To move from the Text Box directly to a control, press Alt + the highlighted letter).  Each of the Command Buttons on the bottom of the dialog is associated with a key.  Press the key to immediately initiate the action associated with the Command Button.
  272.  
  273. "S" is the principal command for calling the Search Dialog.  The "S" command brings up the Search Dialog, leaving the settings unchanged from the last time the dialog was invoked.  For your convenience the "F" and "B" commands are also available to call the Search Dialog.  The "F" command sets the Search Dialog to perform a forward search starting from the current position.  Similarly, the "B" command sets the Search Dialog to perform a backward search starting from the current position.  The setting for Case Sensitive remains unchanged by any of these commands.  Notice that you need remember only one command for calling the Search Dialog, since any setting may be changed within the dialog.
  274.  
  275. The Search Dialog offers the following options:
  276.  
  277. Search for:
  278.  
  279. Type a word or phrase (up to 76 characters long) in the Text Box.
  280.  
  281. Case Sensitive:
  282.  
  283. Check this box to make searches case sensitive.  A case sensitive search for the word "Check" will ignore "CHECK" and "check".
  284.  
  285. Direction:
  286.  
  287. "Forward" searches search forward to the end of the file.  "Backward" searches start at the current position and search backward to the beginning of the file.
  288.  
  289. Start from:
  290.  
  291. A forward search may be started from the current position or from the beginning of the file.  This setting has no relevance to backward searches and is ignored when searching backward.
  292.  
  293. Tag:
  294.  
  295. Pressing Ctrl-Enter or F9 (or tabbing to the "Tag" action button and pressing Enter) will initiate a Search and Tag operation.  HyperView will tag each line in the file that matches the search criteria in the dialog settings.  Where found text occupies more than one line, only the first line will be tagged.
  296.  
  297. Upon the successful completion of a Search and Tag operation, HyperView will display the message "To see condensed view, press ENTER (full screen) or Ctrl-ENTER (split screen)".  This message is simply a reminder, you are free to perform another search or any other HyperView operation.
  298.  
  299. Tagged lines are persistent.  If you do another search, the lines tagged by the first search will remain tagged, until you untag them all with the Clear Tags command or untag them individually with the Space Bar.
  300.  
  301. Search:
  302.  
  303. Pressing Enter will initiate your search.  HyperView will look for the next occurrence of your search text depending on the dialog settings (forward, backward, case sensitive, etc.).  When a match is found, HyperView will move the cursor to the matching line if it is on the current screen, or to the fifth row, if the matching text is off-screen.  This allows you to view search results in context, without the need to scroll back to view preceding text.
  304.  
  305. Cancel:
  306.  
  307. Press Escape to cancel the Search Dialog.
  308.  
  309. Special Characters:
  310.  
  311. You may also search for special characters such as tabs, symbols, and accented characters that are not assigned to a key on your keyboard.  Special characters may be entered into the search Text Box by (a) holding down the ALT key, (b) typing the ASCII code number of the character on the numeric keypad, then (c) releasing the ALT key.  For example to search for a word containing the letter "Ç" (ASCII 128), hold down the ALT key, type the numbers "1", "2", and "8" on the numeric keypad, then release the ALT key.  The ASCII codes for some common special characters are:
  312.  
  313. Tab                 9
  314. Line feed            10
  315. Carriage return    13
  316. Paragraph symbol    20
  317. Section symbol        21
  318.  
  319. Repeating Searches:
  320.  
  321. You may repeat your last search without reopening the Search Dialog.  To repeat a search in the forward directions, press "+".  Press "-" to repeat a search in the backward direction.  It does not matter whether the last search was a conventional search or a search and tag operation.  When you use "+" or "-", HyperView searches for the text in the Text Box the last time any kind of search was performed.  The settings for Case Sensitive will be honored, but the other settings are ignored.  The gray "+" and "-" keys on the numeric keypad are most convenient for repeating searches.
  322.  
  323. A search may be initiated from a full screen view or from one of the two condensed views.  If you initiate a search from one of the condensed views, HyperView will revert to full screen view when the search is successful.  When a successful search and tag operation is initiated from a condensed view, the cursor line moves to the top of the screen for a forward search (or to the bottom of the screen for a backward search), and the rest of the screen if filled with tagged lines.  Please note it is possible that a matching line from the most recent search may not appear on screen.  Whether a matching line is shown will depend on the number of tagged lines there are between the cursor line and the newly added line.  To move directly to the first matching line, press the "+" (forward) or "-" (back) key.
  324.  
  325.  
  326. [TAGGING AND CLEARING LINES]
  327.  
  328. There will be occasions when HyperView tags too many lines or when it is more appropriate to tag a line manually.
  329.  
  330. To untag a single line, position the cursor bar on the line, then press the space bar.  In full screen view the color of the line will change back to the untagged color.  In condensed view the line will be removed from the condensed display.
  331.  
  332. Similarly, to tag a line, position the cursor bar on the line and press the space bar.  The line will be tagged and text on the line will change color to reflect the change.
  333.  
  334. To clear all lines, press "C", then confirm that you wish to clear all tagged lines.
  335.  
  336.  
  337. [SAVING TEXT: GATHER AND LIST]
  338.  
  339. HyperView lets you save text to a file or copy it to the OS/2 clipboard in two different ways--each of which is described in detail below.  Use the Gather command to save one or more contiguous lines of text.  Gathering is like blocking or selecting text in a word processor.  In contrast, the List command only copies those lines that have been tagged.  Listing is loosely analogous to extracting a table of contents or an index from a word processing file.
  340.  
  341. As you can see, Gather and List perform two different functions.  You should also be aware of a difference in the way they save text.  List is line oriented--it saves lines of text from different parts of your file.  If the tagged line does not end with a hard return, HyperView will add one to the end.
  342.  
  343. In contrast, Gather is block oriented.  It saves contiguous blocks of text.  HyperView does not modify Gathered text.  This is generally only relevant with word processing files, which will have hard returns only at the ends of a paragraphs.  This means that you can gather text from an Ami Pro document and paste it into the Golden Compass editor without having to remove extraneous hard returns from the ends of each line.
  344.  
  345. As described below, HyperView suggests different file name extensions for gathered and listed text.  If you prefer, however, you may save both kinds of text to the same file.
  346.  
  347.  
  348. [GATHERING TEXT]
  349.  
  350. Text may be gathered and copied to the OS/2 clipboard or saved to a file.  The process of gathering text is similar to blocking text in a word processor or editor.  To gather text, first move the cursor line to the beginning of the text you wish to save.  Now press "G" or hold down the shift key and press one of the following cursor keys: Up, Down, PgUp, PgDn, Home or End.  Move the cursor to the end of the text you want to gather.  The area will be highlighted as you move around.
  351.  
  352. While gathering text you may use any of the functions available in full screen view, including the cursor keys, jump to line, and search functions.  An on-screen prompt guides you to the completion of Gather operations: press F9 to save text to a file, Ctrl-Insert (or Insert) to copy text to the clipboard, or Ctrl-Shift-Insert to append text to the clipboard.  You may also press Enter for a menu of options.
  353.  
  354. When you copy gathered text to the OS/2 clipboard, the previous contents of the clipboard are overwritten with the new contents.  In contrast, appending text to the clipboard preserves the current contents of the clipboard and adds the gathered text to the end.  Gathered text may then be transferred from the clipboard to your OS/2, Windows, or DOS application.  Please note that the OS/2 clipboard is apparently limited to 64k of text.  If a clipboard operation would exceed 64K, HyperView gives a warning, followed by the option to save the material to a file.  Bear in mind that attempting to append a small amount of text to the clipboard may cause the 64K limit to be exceeded, if the current contents of the clipboard are already close to the limit.
  355.  
  356. If you select "File", HyperView will prompt you for a filename to save the gathered text.  The first time you gather text, HyperView suggests a file name with the same root name as the file you are viewing and the extension ".HVG" (i.e. HyperView gather).  Thus, if you gather text in NEWSLET.TXT, HyperView will propose the filename NEWSLET.HVG to hold the gathered text.  Either accept this suggestion or edit it as you please.  One easy way to change the proposed filename to NEWSLET.SAV is to use the editing keys in the Text Box of the Gather Dialog.  Press End, then Ctrl-Backspace (or F6) to delete the last word (i.e. the extension "HVG"), then type "SAV".  HyperView will remember the file name the next time you wish to save gathered text in the same session.  To reset the default suggestion, clear the text box and press Enter.
  357.  
  358. By default, HyperView appends gathered text to the end of an existing file.  If you prefer to overwrite the contents of a file, then turn off the append check box in the Gather dialog.  Long file names may be used when saving to an HPFS drive.
  359.  
  360. Gathered text from word processing files will be saved in stripped ASCII format, i.e. with a carriage return/line feed combination at the end of a paragraph.  Gathered text from ASCII files will be saved in the same format as the original file.
  361.  
  362.  
  363. [LISTING TAGGED LINES]
  364.  
  365. Tagged lines may be copied to the OS/2 clipboard or saved to a file.  Press "L" to initiate Listing tagged lines.  HyperView will ask whether you wish to save the tagged lines to a file, or copy or append them to the OS/2 clipboard.
  366.  
  367. When you copy tagged lines to the OS/2 clipboard, the previous contents of the clipboard are overwritten with the new contents.  In contrast, appending to the clipboard preserves the current contents of the clipboard and adds the tagged lines to the end.  Tagged lines may then be transferred from the clipboard to your OS/2, Windows, or DOS application.  Please note that the OS/2 clipboard is apparently limited to 64k of text.  If a clipboard operation would exceed 64K, HyperView gives a warning, followed by the option to save the material to a file.  Bear in mind that attempting to append a small amount of text to the clipboard may cause the 64K limit to be exceeded, if the current contents of the clipboard are already close to the limit.
  368.  
  369.   If you select "Clipboard", all tagged lines will be copied to the clipboard and ready for you to transfer to your OS/2, Windows, or DOS application.
  370.  
  371.  
  372. If you select "File", HyperView will prompt you for a filename to save the list of tagged lines.  The first time you use the "L" command HyperView suggests a file name with the same root name as the file you are viewing and the extension ".HVL" (i.e. HyperView list).  Thus, if you wish to list tagged lines in NEWSLET.TXT, HyperView will propose the filename NEWSLET.HVL.  Either accept this suggestion or edit it as you please.  One easy way to change the proposed filename to NEWSLET.SAV is to use the editing keys in the Text Box of the List Dialog.  Press End, then Ctrl-Backspace (or F6) to delete the last word (i.e. the extension "HVL"), then type "SAV".  HyperView will remember the file name the next time you wish to list tagged lines in the same session.  To reset the default suggestion, clear the text box and press Enter.
  373.  
  374. By default, HyperView appends tagged lines to the end of an existing file.  If you prefer to overwrite the contents of a file, then turn off the append check box in the List dialog.  Long file names may be used when saving to an HPFS drive.
  375.  
  376.  
  377. [USING THE OS/2 CLIPBOARD]
  378.  
  379. HyperView lets you copy or append text directly to the OS/2 clipboard.  After you have Listed tagged lines or copied Gathered text to the clipboard, you may paste it into your OS/2, Windows, or DOS applications.
  380.  
  381. To paste text into an OS/2 application, either select "Paste" from the "Edit" menu or press Shift-Insert.
  382.  
  383. To paste text into a Windows application, you must first enable sharing between the OS/2 and Windows clipboards.  Open the settings notebook for the Windows application and select the Session tab.  Now click on the Win-OS/2 settings button and set "WIN_CLIPBOARD" to "On".  After clipboard sharing has been enabled, the process of pasting text into your Windows application is the same as for OS/2 applications:  either select "Paste" from the "Edit" menu or press Shift-Insert.
  384.  
  385. Before you can paste text into a DOS application, the DOS session must be running in a Window.  Click on the icon to the left of the title bar or tap the Alt key.  Now select Paste from the menu.
  386.  
  387. Whereas OS/2 and Windows applications can retrieve text from the clipboard in a single operation, DOS applications must retrieve text letter by letter.  Please understand that this is not a limitation of HyperView or OS/2.  It is an inherent limitation of DOS programs.  If you wish to paste a substantial amount of text into your DOS application, you may, therefore, wish to avoid the clipboard.  First use the Gather or List command to save the text as a file, then retrieve the file into your DOS program.
  388.  
  389.  
  390. [HVAUX.EXE: HYPERVIEW AUXILIARY PROGRAM]
  391.  
  392. HyperView uses a small auxiliary program called HVAUX.EXE to provide an interface between the OS/2 clipboard and all instances of HyperView.  HVAUX is functionally equivalent to  a .DLL.  It is launched by the first HyperView session and automatically terminated with the last.  (Of course, the first and the last could be the same.)  There is never more than one session of HVAUX active at one time.
  393.  
  394. Some may wonder whether a separate program is really necessary for a character mode application to access the clipboard.  The answer is yes.  Although there are techniques by which a character mode application can access the clipboard directly, some PM and Windows programs will not recognize when the clipboard is updated using these methods.
  395.  
  396. HVAUX should be located in the same directory as HyperView.  It is not intended to be run as a stand-alone application; it will be launched by HyperView when required.  If HyperView is unable to start HVAUX, you will receive an appropriate message if you attempt to copy from HyperView to the OS/2 clipboard.
  397.  
  398. HVAUX is a Presentation Manager (PM) program.  It should not be executed when running OS/2 without PM.  This might occur if you boot OS/2 from a floppy, you run CMD.EXE with a CALL command from CONFIG.SYS, or you use TSHELL.  HyperView is smart enough to know when the Presentation Manager is present, in which case it will not load HVAUX and will not offer a clipboard alternative.  The "/B-" startup option is available if HyperView mistakenly believes PM is present when it really is not.  The "/B+" startup option may be used when HyperView thinks PM is not present but it really is.  The "/B+" and "/B-" are intended as fail-safes, to offer a measure of protection against unforeseen eventualities.  Please let me know if need to use either.
  399.  
  400.  
  401. [SETTING THE RIGHT MARGIN]
  402.  
  403. The screen column at which HyperView wraps text to the next line may be set with the "R" command.  When working with standard ASCII files (those with a hard return at the end of each line), the right margin should generally be set to 80 or more, because many such files use all 80 columns of a standard screen.  There is no penalty for setting the right margin to a value greater than the longest line of a standard ASCII file, but setting it to a smaller value will cause the text to appear distorted.  The minimum right margin setting is 35--lower values will be ignored.
  404.  
  405. When working with stripped ASCII files or word processing documents, some users may find 80 columns per line gives the screen a cluttered look.  A right margin setting between 70 and 75 may be more appealing.
  406.  
  407. Please note that a side-effect of altering the right margin is to cause any tagged lines to be cleared.  This happens because the new margin will result in changes to line lengths and the number of lines.
  408.  
  409. At startup, HyperView sets the right margin to 75 if the first file loaded is a word processing file or to 80 if an ASCII file.  Please note that the right margin setting will affect the type of vertical scroll bar HyperView uses.  When the right margin is set to a value that is less than the number of columns, HyperView employs a conventional scroll bar, consisting of a vertical track and a scroll box indicating the relative position in the file.  When the right margin is greater than or equal to the number of columns, only the block representing the file position is displayed.  The vertical track is omitted because it would obscure a column of text.  Since the most common video mode is 80 columns, this means that for most people when the right margin is 79 or less, there will be a conventional scroll bar.
  410.  
  411.  
  412. [JUMPING TO A SPECIFIC LINE]
  413.  
  414. The Jump command ("J") prompts you for a line number, then moves the cursor to that line.  The number of lines in a file is given on the far right side of the status line at the bottom of the screen.
  415.  
  416.  
  417. [TOGGLING TAB EXPANSION]
  418.  
  419. Pressing "T" toggles tab expansion on and off.  When tab expansion is on, HyperView will align text following the tab on the next column that is a multiple of five.  Thus, if a tab is the twelfth character on a line, the next text will print on column fifteen (the next column that is a multiple of five).  When tab expansion is off, tabs appear in their native form--a character resembling a tiny "o".
  420.  
  421.  
  422. [OPENING A NEW FILE]
  423.  
  424. To view a new file, press "N".  HyperView will prompt you for the name of the new file.  For your convenience, the name of the current file will be displayed in the Text Box.  You may either edit the name of the current file or start typing a new name to clear the Text Box.  If the new file is in the current directory, you do not need to type the full path name; the file name will be sufficient.  HyperView will also recognize shorthand path entries using the ".." notation for opening files in parent or sister directories.  If you cannot remember the file name, press F5 to access the Files dialog.
  425.  
  426.  
  427. [FILES]
  428.  
  429. You can use HyperView's directory listing to select a file to view.  The directory listing may be accessed by pressing F5 or by pressing "\".  Using "\" takes you directly to the directory of the current file, positioning the cursor bar on the current file.  As described below, when you press F5, the Files dialog prompts you for a filespec.  In addition, at startup, HyperView will open with a directory listing when no file name is not specified on the command line.  The same is true if the program is started by double clicking on the HyperView icon from the Workplace Shell (assuming no file name is specified in the parameters setting for the HyperView object).
  430.  
  431.     [Directory Listing]
  432.  
  433. The directory listing looks and performs like other directory listing tools you may have used.  If the current directory is a subdirectory, then the ".." notation at the top of the listing signifies the parent directory.  Any subdirectories of the current directory are listed next.  Files are listed in a distinctive color after the subdirectories.
  434.  
  435. To accommodate long file names, HyperView positions file information (size, time, and date) to the right of the screen.  A diamond at the end of a file name indicates part of the name has been truncated because it is too long.  Use the right arrow to scroll the rest of the file name.
  436.  
  437. Pressing the first letter of a directory or file name will advance the cursor bar to the next entry beginning with that letter.  This accelerator feature works cyclically.  In other words, pressing a letter will advance the cursor bar to the next matching entry in the display.  When there are no more files starting with that letter, the accelerator will start again with the directories.
  438.  
  439. To load a file, position the cursor on the file name and press Enter.  If you do not wish to abandon the file you are currently viewing, you may also start a new HyperView session to read a file.  This is known as spawning a new session.  Position the cursor on the file name.  Instead of pressing Enter, press Ctrl-Enter (or F9).  The new session will inherit the same settings as the original session (i.e. colors, lines of text, etc.), except that if raw mode was on, it will be turned off.
  440.  
  441. You may also navigate through the file system directly from the directory listing.  To change to a new directory, position the cursor bar on the appropriate directory name and press Enter.  To move to the parent directory (if any) of the current subdirectory, press Backspace or position the cursor on the ".." entry and press Enter.  To change to a new drive, press Ctrl and the key of the drive (i.e. Ctrl-A, for drive A:, Ctrl-C, for drive C:, etc.).
  442.  
  443.     [Files Dialog]
  444.  
  445. When you press F5, the Files dialog prompts you for a filespec.  (Note: You can avoid the Files dialog and go directly to the directory of the current file, by pressing "\".)  A filespec consists of a drive, directory, and file mask.  The initial filespec will be for all files (*.*) in the current directory on the current drive.  The filespec may be changed by editing the current filespec or by typing a new one.  As explained below it is not necessary to enter a full filespec.  HyperView makes assumptions about any missing information.
  446.  
  447. The last component of a filespec (after the drive and subdirectories) is known as a file mask.  A mask consists of one or more wild card characters and may also include a partial file name.  The commonest file mask is "*.*", which is interpreted as all files.  A file mask in the form of "*.doc" would limit the listing to all files with the ".doc" extension.
  448.  
  449. HyperView will remember any changes you make to the mask component of the filespec.  Thus, if you change the mask to "*.doc", HyperView will remember the change each time you change a directory from the Files directory listing or call the Files dialog.  To change the mask again, or to revert back to "*.*", edit the mask appropriately or simply type the new mask by itself.  The file mask is limited to 30 characters.  Any excess characters are truncated.  On FAT drives, a mask with characters in excess of 8.3 (base.extension) is considered invalid by the system.
  450.  
  451.  Note:  If you are accustomed to the peculiar operation of the "*" wild card under true DOS, you may not have realized that it operates differently under OS/2.  DOS ignores any letters that appear after a "*".  Thus, under DOS the mask "n*k.*" will match all files beginning with the letter "n", regardless of the last character in the root name.  Under OS/2 (and OS/2 DOS emulation), only root names beginning with "n" and ending with "k" will match (e.g. notebook.doc, but not notes.doc).  As a corollary, you may also use a "*" more than once in a mask to match one or more characters in each position.  For example, the mask "n*b*k.*" will be correctly interpreted by OS/2.  Since HyperView is an OS/2 program, it follows the OS/2 convention.
  452.  
  453. The logic of the filespec entry field parallels that of the OS/2 (and DOS) DIR command.  This permits you to enter a minimal amount of information to change the filespec.  HyperView makes the same assumptions about the missing information that the DIR command would make.  If you are comfortable at the command line, then the following examples will make sense to you.  On the other hand, if the command line bewilders you, then the logic may present itself as a set of incomprehensible rules, each of which must be memorized independently.  In this case, you it may be more sensible to edit the filespec prompt than to learn a series of recondite rules.
  454.  
  455. From the Files dialog:
  456.  
  457.  To change to the current directory on another drive, type "d:", where "d" signifies the letter of the new drive.
  458.  
  459.  To change to the root directory on another drive, type "d:\", where "d" signifies the letter of the new drive.
  460.  
  461.  To change to the root directory of the current drive, type "\".
  462.  
  463.  To change to a sister directory of the current directory called UTILS, type "..\UTILS".
  464.  
  465.  To change the file mask from "*.*" to "*.doc", type "*.doc".  To change the mask back to "*.*", type "*.*".
  466.  
  467. These are only examples, and not an comprehensive listing of available shortcuts.  In an excess of caution, let me also say that you do not type "DIR" in the Files dialog, nor do you type any of the switches that are available with the DIR command.
  468.  
  469.  
  470. [GETTING HELP]
  471.  
  472. A Help summary listing of all commands is available by pressing F1.  Pressing F1 again from the Help screen tells you "About" HyperView.  An effective way to get more help is to open a second copy of HyperView to read this document.
  473.  
  474.  
  475. [EXITING HYPERVIEW]
  476.  
  477. To exit immediately from HyperView, press Alt-F4.  You may also exit HyperView by pressing Escape from the full screen view.  The latter method requires confirmation that you really do wish to exit.
  478.  
  479. As a convenience, when you exit, HyperView leaves the last screen of text on the display and moves the cursor to the bottom row.  If you prefer to exit to a clear screen, use Alt-X.  These distinctions are probably meaningful only if you run HyperView from the command line.  Users running HyperView from the Workplace Shell will probably set the HyperView window to close on exit, in which case it does not matter what was on the screen when the program ended.
  480.  
  481.  
  482. [READING WORD PROCESSING FILES]
  483.  
  484. HyperView automatically recognizes and reads the following word processing formats:  Ami Pro, DeScribe (versions 2 through 5), Microsoft Word for Windows (versions 1.x, 2.0, and 6.0) and WordPerfect (versions 5.x and 6.0).  Please let me know if you feel I have omitted a word processor with a substantial following among OS/2 users.  Any file that HyperView does not recognize as a word processing document will be treated as if it were ASCII text.
  485.  
  486. HyperView's mission is to allow you to isolate and extract information from word processing and text documents.  Accordingly, when converting word processing files, it generally ignores most formatting such as headers, footers, centering, etc.  It also ignores footnotes, endnotes, and graphics boxes that may contain text.
  487.  
  488. When possible, HyperView will convert those characters that the word processor treats as special characters to their ASCII equivalents.  If HyperView is unable to convert the character, it will substitute a space.  Should you find that HyperView fails to convert a significant number of word processing characters, you may wish to have your word processor perform the conversion, then use HyperView to isolate information in the document.  HyperView will perform best if the file is saved in stripped ASCII format--with a hard return at the end of a paragraph.
  489.  
  490. To disable HyperView's automatic recognition and conversion of word processing files, use the "/R" startup option, (i.e. HV /R).  HyperView will then treat all files as ASCII files.
  491.  
  492. The following notes apply to the conversion process:
  493.  
  494. Text contained in tables in word processing documents are typically converted to a series of discrete paragraphs on a cell by cell basis.
  495.  
  496. Hidden text in WinWord documents is treated as ordinary text.  In WordPerfect 6.0 documents, hidden text is enclosed in square brackets, i.e. [This is how WordPerfect hidden text is converted.].
  497.  
  498. Microsoft Word for Windows offers a fast save option in which only the changes to a document are saved.  If a document has been "fast saved", HyperView will only read text from the last full save.  For most users, it is advisable--for a variety of reasons--to disable Word's fast save option.
  499.  
  500. As of the current release of HyperView, Microsoft had only partially documented the Word for Windows 6.0 file structure.  Consequently, there is a small possibility that HyperView will not recognize a WinWord6 document.
  501.  
  502. Encrypted WordPerfect and WinWord files are not readable.  When HyperView encounters an encrypted document, it will offer you the opportunity to load another file.
  503.  
  504. DeScribe uses a sophisticated frame structure.  HyperView converts DeScribe text frames in the order they are stored in the document.  Headers and footers are contained in frames, and HyperView displays the first instance of a header and footer.
  505.  
  506.  
  507. [NATIONAL LANGUAGE SUPPORT]
  508.  
  509. Using OS/2's built-in language support, HyperView will support case insensitive searches in any language, based on the currently selected code page.  Please note, however, that special characters in word processing files may not be converted to their proper ASCII equivalents.
  510.  
  511. HyperView will also correctly sort directory listings containing accented characters.
  512.  
  513.  
  514. [TIPS AND SUGGESTIONS]
  515.  
  516. There may be occasions when you wish to edit a document in one window and view it with HyperView in another.  Each time you save the file in your editor or word processor, you can refresh HyperView by pressing "N" (for new file), then pressing Enter when HyperView prompts you with the name of the current file.
  517.  
  518. To quickly convert a file to stripped ASCII from one of HyperView's supported word processing formats:  (a) load the file into HyperView, (b) press "G" (for gather), (c) press End (move to the end of the file), then (d) press Enter (finish gathering).  Please note you can combine steps (b) and (c) by pressing Shift-End.
  519.  
  520. When running HyperView in a window, it may be convenient to decrease the size of the right margin.  (The minimum length is 35 characters.)  The width of the window can then be resized, leaving more room on the desktop without obscuring any text.  This is recommended only when working with word processing and stripped ASCII files.
  521.  
  522. The line length of programming source code files may exceed 80 columns.  To prevent HyperView from wrapping the end of a long line to the next line, set the right margin to an arbitrarily large value that is greater than the longest line.
  523.  
  524.  
  525. [PROGRAM NOTES]
  526.  
  527. HyperView is written entirely in assembly language.  Charles Petzold's articles in PC Magazine provided an informative introduction to assembler programming for the OS/2 platform.  These articles are still relevant and exciting many years after their original publication.  Petzold's recently revised OS/2 Presentation Manager Programming proved helpful in tackling the issues related to HyperView's clipboard capability.  In addition, the assembly language programs and articles published in PC Magazine (some of which were republished in Ray Duncan's Power Programming with Microsoft Macro Assembler) frequently provided a starting point for attacking similar tasks in OS/2.  Crescent Software's documentation and the assembly language source code for their BASIC language libraries were also useful.  Finally, sample code demonstrating multithreading OS/2 applications by Monte Copeland provided a valuable reference for the design of HVAUX.
  528.  
  529. Zen of Assembly Language and Zen of Code Optimization by Michael Abrash are continuing sources of insight.  Programmer's Technical Reference: The Processor and Coprocessor by Robert L. Hummel is another valuable reference.
  530.  
  531. Pete Norloff's OS/2 Shareware BBS (703-385-4325) is an outstanding OS/2 resource--for developers and end users alike.  Browsing through the list of files can be like rummaging through someone's attic, except that Pete's BBS has a much higher percentage of treasures.
  532.  
  533. For others desiring to write assembly language programs for OS/2, MASM version 6.11 will run in an OS/2 DOS session with DPMI_DOS_API set to ENABLED and DPMI_MEMORY_LIMIT set to 10.  For $15, Microsoft will downgrade owners of MASM 6.1 or greater to MASM 6.0b (the last version to run as a native OS/2 application).  Programs assembled with MASM may be debugged with IPMD (the IBM PM debugger), which is packaged with IBM CSet++ FirstStep for OS/2.  Along with OS/2 itself and a year's subscription on the OS/2 Shareware BBS, FirstStep is one of the great bargains in the computer world.  And I say that as one who does not even use the C compiler.
  534.  
  535. The source code for HyperView was written with Multi-Edit, which also served as a model for parts of the user interface.  Some details regarding the file structures of Ami Pro and Word for Windows were derived from Jay Munro's article in PC Magazine (June 29, 1993).  WordPerfect's file structure is documented in the WordPerfect Developer's Toolkit.  Microsoft provided partial documentation of the WinWord6 file structure.  Allan Katzen, then President, and John Serences, Vice-President for Research & Development, were particularly generous in taking time out from the development of version 5.0 of DeScribe, to supply information on DeScribe's file structure.  Lotus Development Corporation, Word Processing Division provided documentation of Ami Pro's file structure.
  536.  
  537. Herb Tyson--author of many outstanding books including Your OS/2 2.1 Consultant and Word for Windows 6 Super Book--generously offered his advice on HyperView's features and assisted the author in procuring information on the file structures of DeScribe, WinWord and Ami Pro.  As I write this (November 1994) Herb's new book Your OS/2 Warp Version 3 Consultant is in press and should prove an excellent reference for both novice and experienced OS/2 users.  Incidentally, the Super Book is a superb choice for many reasons, but especially for its tips on running Word under OS/2.
  538.  
  539.  
  540. [STANDARD DISCLAIMERS]
  541.  
  542. Most personal computer users realize that only the blandest warranties accompany software.  This software is no different from any other in that respect.  Accordingly, there are no warranties of merchantability or fitness for a particular purpose, nor will the author be responsible for any damages (incidental, consequential, or otherwise) in excess of the purchase price.
  543.  
  544.  
  545. [SUPPORT]
  546.  
  547. Let me know if you encounter any difficulties with HyperView.  Please be as specific as possible and be sure to supply the HyperView version number.  The version number may be obtained from within HyperView by pressing F1 twice ("Help", then "About") or by running HyperView with the /? option (i.e. HV /?).  The best way to communicate with me is by E-mail over CompuServe.  My ID number is 76170,1627.  You may also reach me on the OS/2 Shareware BBS, where I log on as "Mike Shacter".  I do not mind taking phone calls, but I am not in a position to return long distance calls.
  548.  
  549. You do not need to register before receiving assistance in resolving problems with HyperView.  One of the great advantages of user supported software is the opportunity to verify that a program works before purchasing it.  This imposes a reciprocal responsibility: to register when you know the program works for you.
  550.  
  551.  
  552. [REGISTRATION]
  553.  
  554. HyperView is a user supported program.  It is not public domain.  To continue using HyperView, you must pay a $35 registration fee.  If you feel the program is worth more than $35, you still pay the same amount, but you believe you got a better deal.  For business use, each person using HyperView at a site must be registered.  Volume discounts and site licenses are available--please write for details.
  555.  
  556. HyperView is not disabled in any respect.  Nor are there any reminders to register the program.  I hope to be able to continue that policy.  My philosophy is that $5 worth of annoyance will not induce people to register a $35 program.  Raising the level of annoyance will simply aggravate potential customers.
  557.  
  558. To register HyperView, please send your check or money order to:
  559.  
  560.             Michael H. Shacter
  561.             10309 Parkwood Drive
  562.             Kensington, Maryland 20895-4041
  563.  
  564. In exchange, you will receive an acknowledgement and at least $35 worth of satisfaction.  (Payment for orders outside the U.S.A. must by check or money order drawn on a U.S. bank or by international money order.  I know this is a nuisance, and I am sorry.)  Note that you will not be sent a disk, only a registration number.  If you absolutely must have a copy of HyperView on disk, send an additional $5 ($10 for foreign orders).  Please (a) specify 5¼ or 3½ disk size, (b) include 5% sales tax if you are a Maryland resident, and (c) be patient.  For your convenience, a registration form is included with this package.  Please see the file REGISTER.FRM.
  565.  
  566. As of the date of this release, HyperView may be found on the OS/2 Shareware BBS (703-385-4325) and on CompuServe in library 1 of the OS2BVEN forum (also known as OS2SHARE).  On CompuServe the most current version will always be known as HV.ZIP.  If necessary, registered users may secure the most current version of my programs from me for a $5 shipping and handling fee.  Remember to specify disk size.
  567.  
  568.  
  569. [RESTRICTIONS]
  570.  
  571. All authorized users are granted a limited license to make copies of HyperView without charge, subject to the restrictions contained elsewhere in this document as well these:
  572.  
  573.     (a) HyperView must be distributed in absolutely unmodified form, including the program and documentation.
  574.  
  575.     (b) For-profit use of HyperView without a license is prohibited.
  576.  
  577.     (c) HyperView may not be included or bundled with any other product for any reason.
  578.  
  579. Not-for-profit user's groups, such as the Capital PC User Group, are permitted to charge a small fee for materials, handling, postage, and general overhead.  No other organization is permitted to charge for distribution of copies of HyperView.
  580.  
  581. Electronic bulletin board system operators are encouraged to post HyperView on their bulletin board systems for downloading by their users, if the above conditions are met, and if no special fee is necessary to access the HyperView files (a general fee to access the BBS is acceptable).  Likewise, all authorized users are encouraged to upload to HyperView to BBS meeting these requirements.
  582.